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Features and Facilities 

BB Utility with, wliicli users may sulsiQit jobs, with an 
optional schedule time, to the hatch processor queue. 

BBCANGEL Cancels and logs the currently active hatch job. 

BBDEL Deletes a pending job from the batch queue, if 
executed by the user who submitted the job. 

BBLIST Lists all jobs running in the batch processor and 
pending on the batch queue. 

DIRDUMP Gives master directory of any disk, sorted by user 
area. 



GO 



Moves user to a user area specified by a user-defined 
name . 



GONAME Allows users to define names for user areas on the 
system, and to list these area names sorted 
alphabetically or by user area number. 

HELP On-line help facility providing help on all TurboDOS 
and Turbo-Plus commands. Additionally, users may add 
their own help files to this global function. 

LOCATE Searches certain or all system drives for a given file 
or template. 

LOG Allows user to make time-stamped entries in a daily 
log file - particularly useful for .DO files submitted 
to the batch processor. 

LOGOFF Enhanced version of system logoff notifying users of 
pending rnail^ and displaying system bulletins = 

LOGON Enhanced version of system logon notifying users of 
pending mail, displaying system bulletins, and 
providing additional levels of privilege. 

MAIL TurboDOS mail facility to allow electronic mail to be 
sent between users on the system. 

MASTER Enhanced version of the system 'MASTER' command, 
providing better control of access to the master 
processor. 

PROFILE Menu-driven utility to maintain system USERID.SYS 
file. 

RESET Program to reset a slave from another slave. 

STATUS TurboDOS facility to continuously monitor activity of 
system users, printers, and buffers. 
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TWX TurboDOS TWX facility to allow users to send immediate 
single or multi-line messages to other consoles on the 
system. 

USER Allows user to change user areas on the current disk 
drive. Performs the same function as the former 
TurboDOS command of the same name. 

MHO TurboDOS system status facility to display all current 
users on the system, the processes which they are 
running, and other current system characteristics. 
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OVEBVIEW 

TurlDO-PlTis is a set of utilities and function calls which enhance 
the TurboDOS Operating System, making extensive use of the User 
Defined Function, (TurboDOS call 29H) in the process. This 
manual is designed to provide all of the necessary information to 
fully utilize these commands and functions. 

The manual is divided into sections providing an overview of the 
package, instructions on using each command, and information 
about all of the new function calls. 

Theory of Operation 

Turbo-Plus consists of two primary divisions: the background 
batch processor, and the inter-user oriented utilities. 

The background batch processor (BB) enables an extra slave board, 
not attached to any console, to run jobs submitted by other users 
on the system, thus allowing the other users to keep their 
terminals from being tied up by long-running jobs. BB accepts 
any valid TurboDOS coimnand line as a coimnand, suffixed, if 
desired, by a schedule time. Each submitted job is placed on a 
disk-resident queue which is then serviced by the batch 
processor. All users on the system are able to monitor the 
status of the processor, and any user may delete a j ob which he 
submitted while it is still in the pending state, or abort a job 
while it is running. 

Most of the remaining utilities in Turbo-Plus use the extensions 
to the TurboDOS function calls included in Turbo-Plus. These 
functions maintain lists in memory containing information about 
each station on the system as well as the master. This 
information creates the ability to have additional commands, such 
as the WHO coimnand, to find out who is currently logged onto each 
station; the MAIL command; a complete inter-user mail facility; 
the TVX conmiand, to send messages to other users on the system, 
the BESET command, to reset stations which are down (like the 
RESET command of TurboDoS Version l.lx)*, and a new MASTER 
command, limiting the number of stations simultaneously attached 
to the master processor to one, and thus eliminating any 
contention problems that may currently occur. Turbo-Plus also 
adds the ability to restrict users to specified disk drives on 
the system, providing an additional level of system security. 



No t e : The RESET and BBCANCEL commands will not work on certain 
hardware configurations. If you are having difficulty using 
these commands, consult your dealer. 
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COMMANDS 



BB Command 



The BB command enables you to enter a job 
onto tlie batch, queue. 



Syntax 



Explanation 



BB command 

BB command @hh:mm 

BB command @hh:mm+d 



The 'command' argument is any legal TurboDOS 
command which will not require any console 






o.. ^V. 






processor to reset itself, providing that the 
CONBB module has been included in your slave 
generation. (See Installation guide to Turbo- 
Plus) . 

The second form of the coimnand is used for 
scheduling jobs. hh:mm is the time which the 
job should run in 24 hour time. The +d is a 
further option, shown in the third form of 
the command, which specifies the niimber of 
days later that the job is to be run. (e.g. 
@00:00+2 means 'Run the job at midnight 
tomorrow night . ' ) . 

A multi-command string may be entered onto 
the batch queue. This coimnand' s format 
should be similar to a multiple command 
entered directly onto the Conmiand Line 
Interpreter, except that the vertical bar 
character ( ! ) should be substituted for the 
back-slash character (\) expected by 
TurboDOS . 



Examples 



OA}BB DO REPORT @00:00+l 

BATCH JOB 0308 QXTEUED-WAITING 02 TO RUN 

OA}BB PRINT FILE! DO PRINT 

BATCH JOB 1969 QUEUED-WAITING 01 TO RUN 



Error Messages 



CoEomand line is empty 

Bad format in schedule time 

Bad format in schedule day 
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Parameters 



2-2 



USER =01 



User number where 

BB processor resides. 



DRIVE =01 



Drive (0=A, 1=B, etc.) 
where BB processor 
resides . 



BBCANCEL Command 



Syntax 



Explanation 



Examp 1 6 s 



The BBCANCEL 
execution of 
processor . 
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command enables you to stop the 
an actlTe job in the batch 



BBCANCEL 



Since there is at most one job running at any 
time, no job number is required on the 
command line. 



either a 

r» ^ ^^ X 



This command must be issued by 
privilefted user qi» "hv *. ^^aa•n -ii-nHa-n . „.. 

- ^ — ^ —■—»«»* U.AA WL w* UXXO LlOOX'lU. 

from which the job was queued. Otherwise, 
the warning: "***User Unauthorized to Delete 
Job" will be issued. If the deletion is 
successful, a message will appear on the 
console stating the job number and user area 
from which is was queued. 



SPIBBCANCEL 
JOB #: 1120 



QUEUED BY SYSTEM FROM 08-J CANCELLED 



Error Messages 



User Unauthorized to delete job 
There is no job currently running 



Parameters 



USER =01 
DRIVE = 01 

BSLAVE =01 



User number where 

BB processor resides. 

Drive (0=A, 1=B, etc.) 
where BB processor 
resides . 

Slave number (0=A, 
1=B, etc. ) of BB 
processor. 
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BBDEL Command 

Syntax 



The BBDEL command enables you to delete a 
pending job from the batch queue. 



BBDEL nnnn 



Explanation 



Examples 



The 'nnnn' argument is the job n\imber to 
deleted (leading zeroes may be left off). 



be 



This command must be issued by either a 
privileged user or by a user under the userid 
from which the job was queued. Otherwise, 
the warning: "***User Unauthorized to Delete 
Job" will be issued. If the deletion is 
successful, a message will appear on the 
console stating the job number and userid and 
area from which is was queued. 



1 OF) BBDEL 46 

JOB #: 0046 QUEUED BY SYSTEM FROM 10-F: 



DELETED 



Error Messages 



Illegal job number 

Job not found 

User unauthorized to delete job 



Parameters 



USER ==01 



DRIVE =01 



User number where 

BB processor resides. 

Drive (0=A, 1=B, etc.) 
where BB processor 
resides . 
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The BBLIST command enables the user to list 
the current and pending jobs on the batch 
queue . 



anhiST I ; options; 



Explanation 



The report consists of two sections. The 
first, only present when there is a job 
currently running, lists that job. The second 
half lists all jobs waiting on the batch 
queue . 



Options 



Examp 1 e s 



For all jobs, it lists the job number, the id 
of the user who requested it, the user area 
from which it was queued, and the request 
time. For the current job it also includes 
the time the job began running, and for the 
pending jobs it includes the time for which 
the job is scheduled. 



! Option 



Explanation 



;F 



The report will include with 
each job line, the command 
string which was queued. 



SFI BBLIST 

BACKGROUND BATCH: 26-Mar-84 AT 11:32 

CUEEENT PROCESS: 

JOB # 045 QUEUED BY RJ FROM 2-J AT 09:06:12 - BEGAN: 09: 06:47 

PENDING PROCESSES: 

JOB # 046 QUEUED BY JG FROM 10-F AT 10:00:01 FOR 10:00 
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6F} BBLIST j_F 

BACKGROUND BATCH: 26-Mar-84 AT 11:32 

CURRENT PROCESS: 

JOB # 045 QUEUED BY RJ PROM 2-J AT 09:06:12 - BEGAN: 09: 06:47 

* DO 3TAM101 

PENDING PROCESSES: 

JOB # 046 QUEUED BY JG FROM 10-F AT 10:00:01 FOR 10:00 

* DO REPORT 



Parameters 



USER =01 



User niimber where 

BB processor resides. 



DRIVE =01 



Drive (0=A, 1=B, etc.) 
where BB processor 
resides . 
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DIBDUMF Command 



Syntax 



The DIRDUMP command enables you to get a 
master directory of a disk drive. 



I DIRDUMP d: {;options} 
I DIRDUMP {; opt ions} 



Explanation 



If you specify a drive letter, as in the 
first example, the master directory will be 
obtained for that drive. Otherwise, the 
current drive will be listed. 



The report will have a heading consisting of 
the disk's label and the current date and 
time. Following this it will list the user 
areas in order from to 31, omitting any 
which are empty, producing in each area a 
directory sorted alphabetically. It will 
give the total disk usage for each area 
consisting of n\imber of files, and number of 
K in use . 



Options 



The program will take a few minutes to sort 
the directory. Once the sort is complete, it 
will send the report either to the screen or 
the printer, as specified by the option. If 
sent to the screen, it will pause after each 
screenful for you to press the RETURN key: 



Options 



Explanation 



;L The directory listing is to be 
sent to the printer instead of 
the console. 



Ex amp 1 e s 



6D1 DIRDUMP 

...(display of all files on drive D) 
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Parameters 



CLSCE = 1,1A 



This may be a string ol 
up to 10 bytes for the 
terminal clear-screen 
sequence. The first byte 
specifies the length of 
the string. 
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GO Comm&iid 



Tlie GO conun&nd. en&bles you "to move &rouiid. 
"between user areas whose names were 
predefined using the GONAME utility. (cf. 
GONAMB Command) , 



Syntax 




Explanation 



with 



The argument is the predefined name of a user 
area, up to eight characters in length. If 
the argument is not matched, GO will look for 
fi^pac^ name whose f ipst n letteps a^pes 
'argument', where n is the length of 
'argument'. If no such name exists, GO will 
return the message 'No Such User Area 
Defined'. If a non-privileged user attempts 
to use this coimnand, the same message will he 
printed. 



Ex amp 1 e 



6P}G0 SYSTEM 

OAIGO JJJ 

No Such User Area Defined 

OAlGO TURBO 

SPIGO SY 

OA) 



Error Messages 



No Area on Command Line 
No Such User Area Defined 



Parameters 



SDRIVE = 01 



System search drive 
(1=A, 2=B, etc.) 
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60NAME Command The GONAME command enables you to ©staMish 

names for various user areas on tli« system. 



Syntax 



GONAME 



Explanation The program, which is menu driven, enables 

you to create area names, delete area names, 
and produce listings of the user areas and 
their names, both In user n\imber order and in 
alphabetical order. 

Upon issuing the GONAME command, the user 
will be presented with the following menu: 

1) Enter User Area Names 

2) Delete User Area Names 

3) List Areas Alphabetically 

4) List Areas in User Number Order 

5) Exit 

If the user specifies choice 1, he will be 
prompted for the user number, then the drive, 
and finally the assigned name. Pressing the 
return key for either of the first two 
prompts will return the user to the main 
menu. If a duplicate name is given, an error 
message will be returned. 

If the user specifies choice Z, he will be 
prompted for the name to delete. Pressing 
the return key will return him to the main 
menu. Giving a name will result in either 
the name being deleted, or, if it is not 
found, an error message being returned. 

If the user specifies choice 3 or 4, he will 
be asked whether the output should go to the 
Terminal or the Printer. Following this 
choice, the areas will be listed in two 
columns, where the first is the user area 
(e.g. 11-G) and the second is the name 
associated with it. For choice 3, the order 
will be alphabetical by name. For choice 4, 
the order will be by user area, which means 
that first all of A drive will be listed in 
user number order, then all of B drive, etc. 

If the user specifies choice 5, he will be 
returned to the operating system. 
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Parameters 



SDRIVB = 01 



CLSCR = 1,1A 



System search drive 
(1=A, 2=B, etc.) 

This may be a string of 
up to 10 bytes for the 
terminal clear-screen 
sequence. the first byte 
specifies the length of 
the string. 
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HELP Command 



The HELP command enables you to obtain 
information about various TurboDOS and Turbo- 
Plus commands. 



Syntax 




BiXPiaymtion 



The 'command' arg\iment is optional, and if 
present indicates the command for which you 
require assistance. 



If the argument is omitted, HELP wi 1 1 provide 
a list of all the topics for which help is 
available. Any of these topics may then be 
used as an argument to obtain more specific 
Information. 

When an argument is present, HELP will 
provide the information on all topics 
matching the string provided, 

After each screenful of information is 
printed, HELP will pause and wait for a 
carriage return input from the console before 
continuing. To abort at this point, press 
'X' . 

Note : If you wish to add your own help files 
to the facility, simply create a file called 
command. HLP on user zero of your search 
drive; set the global attribute on the file, 
and it will be included in future HELP 
1 i stings . 



Parameters 



SDHIVE = 01 



System search drive 
(1=A, 2=B, etc.) 
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T.ofi A'l'H. ConuD&nu. 



Tlie LOCATE command enables you to search, one 
or more active drives on the system for a 
given file or files. 



Syntax 



LOCATE filename {; opt ions} 
LOCATE { ; opt ions} 



Explanation 



If "filename" contains wild-cards, 
coimnand can be used to find more 
file on the system. 



the LOCATE 
than one 



The "options" argument may be any combination 
of the letters A-P, S, or '*'. A-P and '*' 
specify the drives on which to search, and 
the order in which to perform the search. S 
means that the program should stop after it 
finds the first match. The default setting 
is to search every drive on the system, and 
not stop, i.e. ' ; * ' . 



Examples 



If "filename" is omitted from the coimnand 
line, then the LOCATE command operates in an 
interactive mode. It accepts commands from 
the console, prompted by an asterisk, until a 
null command is entered. The commands in 
interactive mode do not accept options of 
their own, but rather obey the options set in 
the initial program invocation. 



OA} LOCATE *.PPJg;GD* 



????????. PEN 








Searching Drive 


G 






SYSTEM . PEN 




5- 


-G 


PROGBAM .PEN 


21- 


-G 


Searching Drive 


D 






STAM . PEN 




2- 


-D 


Searching Drive 


A 






C0N96 . PEN 




0- 


-A 


Searching Drive 


B 






Searching Drive 


C 






Searching Drive 


E 






Searching Drive 


F 






LOCATE . PEN 




3- 


-F 


Searching Drive 


H 






Searching Drive 


I 
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OA } LOCATE ;S 
* TEST.BAS 



TEST 



.BAS 



Searching Drive A 

Searching Drive B 

Searching Drive C 

Searching Drive D 

TEST .BAS 10-D 

* LAB*. PAS 

LAB?????. PAS 

Searching Drive A 
Searching Drive B 
Searching Drive C 
Searching Drive D 
Searching Drive E 
Searching Drive P 
LAB2A .PAS 13-F 



OA} 
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LOG Conunand 



The XiOG comm&nd en&lsles you to lo^ tlie 
progress of a job in a special file. 



Syntax 




Explanation 



This command will get the system date, and 
create a file of the name mmddyy.LOG if it 
does not already exist. Then it will append 
your comments, preceded by the date and time 
to the end of the file, as well as printing 
them on the console. 

This coimnand is particularly useful for a job 
running in a batch processor as part of a .DO 
file. It is possible to insert LOG commands 
at various points in the file so that as the 
job passes each critical point, it can log 
its progress into the file, allowing another 
user to check on it. 



Example 



lOFlLOG STARTING JOB 

10/19/83 09:12:54 STARTING JOB 



lOFlLOG JOB COMPLETE 

10/19/83 10:83:38 JOB COMPLETE 

1 OF} TYPE 101983.LOG 

10/19/83 09:18:64 STARTING JOB 

10/19/83 10:23:38 JOB COMPLETE 



lOF} 
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LOGOFF Command 



The LOGOFF command is used in multi-user 
configurations of TurboDOS to termiijate your 
session. 



Syntax 




Bxpla,n%ti 



The LOGOFF coimnand sets the user number to a 
reserved value (31), selects the system drive 
as the default disk, and makes the TurboDOS 
function call to log the user off. The user 
will then, under normal configurations, have 
the WAEMSTBT.AUT file, containing L0G0N.COM, 
automatically, loaded, prohibiting further 
activity until a successful LOGON has been 
accompl ished. 

If there is a BULLETIN. OFF file on user of 
the system search drive, its contents get 
printed on the screen prior to logoff. The 
file must have the global attribute set in 
Qj.(3_ep fQj» j^Qj^_pj,|^|jgggjj ^gQj,g ^Q receive it. 

Also, if the user logging off has any mail 
pending, he will receive a message stating so 
and will be asked whether he wants to log 
off. If he says no, he remains on the system 
and may receive his mail. (Cf. HAIL Command) 



If the library for user 31 on the system 
drive also contains a file named 
"SYSLOG.SYS", then the LOGOFF command will 
automatically record your log-off in that 
file, and will display the information going 
into the file on your screen. 



Note: The SYSLOG.SYS file maintained by 
Turbo-Plus has a format different from that 
maintained by TurboDOS. If you are running 
any programs which read this file, expecting 
the normal structure, they should be 
modified. Figure 2-1 shows a typical 
SYSLOG.SYS file. 



Examp 1 e 



50} LOGOFF 
Logged Off . , . 



2-16 



User's Giiide to Turbo-Plus 



LOGON Comin&iid 



Tliere are substantial differences between 
this command and tlie LOGON command as 
supplied with TurboDOS. Please read this 
section careful ly. The LOGON command provides 



password-type 
configurations 
this command 
access to the 
file libraries 



security in multi-user 

of TurboDOS- The purpose of 

is to prevent unauthorized 

system and to protect private 



Syntax 




Explanation 



LOGON is normally used as a WABHSTHT.AUT file 
on user 31 of the system boot disk, rather 
than as a explicit command. Upon entering 
LOGON, you are prompted to enter your user-ID 
from the console keyboard. The user-ID is 
validated against the file USERID.SYS in the 
user 31 library. USERID.SYS is an ASCII text 
file containing entries of the form: 

userid, [password], usno[P3, [drv], [cmd], [ace] 

where "userid" and "password" are up to 8 
characters in length, "usno" is a user number 
0...30, "drv" is a drive letter A. . .P, "cmd" 
is any valid TurboDOS command line, and "ace" 
is a string of up to sixteen drive names. 
The password, drive, command line and access 
fields are optional. 

Mi. Jf \J MX «.LO@^ i,iJ AACkO CkAX CkOOVN/X&W^UL ^a>O0*«UA\X 

specified in USERID.SYS, then LOGON prompts 
you to enter a password, and validates it. 
The log-on succeeds only if you enter both 
the user-ID and password correctly, in which 
case your console is logged onto the 
specified user n\imber, and the specified 
drive is selected as the default disk. If the 
"cmd" field is present, that coimnand line is 
executed. If your entry in USERID.SYS has 
the user number suffix "P", you are logged-on 
as a "privileged" user, enabling you to 
access various protected facilities of 
TurboDOS . 

The access field is optional and, if present, 
should be a string between one and sixteen 
bytes long, containing any combination of the 
letters A-P. Any letters present indicate 
disk drives to which that user may have 
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access. The list should include the system 
search drive and spool drive, as well as any 
other drives desired. If the field is 
absent, the user may access all drives. 

If the user 31 library also contains a file 
named S7SL06.SYS. then the LOGON command will 
automatically record your log-on in that 
file. 

Note: The SYSLOG.SYS file maintained by 
Turbo-Plus has a format different from that 
maintained by TurboDOS. If you are running 
any programs which read this file, expecting 
the normal structure, they should be 
modified. Figure 2-1 shows a typical 
SYSLOG.SYS file. 



If user on the system search drive contains 
a file named BULLETIN. ON, then the contents 
of that file will be printed on the screen 
following a successful logon. This 
facilitates the broadcast of announcements 
about the system. The file must have the 
gldlial attribute set in order for non- 
privileged users to receive it. 



If the userid 
pending, LOGON 
screen stating: 
He may then use 



logging on has any new mail 
will print a message on the 
"*** You have new mail «««»'. 

the MAIL Facility (Of. MAIL 



Command) to receive his mail 



Parameters 



SDRIVE -^ 8 



LOGMSG = 'X 



CLSCH = 1,1A 



System search drive 
(1=A, 2=B, etc.) 

x' User-specified logon 
message, terminated 
with 't' 

This may be a string of 
up to 10 bytes for the 
terminal clear-screen 
sequence. The first byte 
specifies the length of 
the string. 
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Figure 2-1 
Sample Turbo-Plus SYSLOG.SYS 



The structure of SYSLOG.SYS is: 





First Column 


Las 


t Column 


Contents 












1 




9 






Date 














11 




18 






Time 














20 




27 






U£ 


lerid 












29 




29 






Stati( 


3n Lett 


er 










32 




34 






User Number 












36 




36 






Drive 














42 




64 






Activ 


Lty 






19 


Oct 


83 


06:51:50 


LV 




i; 


I 2P 


K 


« » « 


ON: 






19 


Oct 


83 


06:57:26 


LV 




i; 


I 02 




« « « 




LOG 


OFF 


19 


Oct 


83 


08:26:14 


JG 




^c; 


1 3P 


Y 


» » » 


ON: 






19 


Oct 


83 


08:49:36 


SKA.7 




f; 


I 12 


B 


« « « 


ON: 






19 


Oct 


83 


09:28:49 


HJ 




.i; 


) 8P 


L 


% s ae 


ON: 






19 


Oct 


83 


09:35:31 


LV 




a; 


1 2P 


K 


« * » 


ON: 






19 


Oct 


83 


09:40:31 


JG 




c: 


1 10 




« « « 




LOG 


OFF 


19 


Oct 


83 


10:48:47 


SKA.7 




f: 


I 12 




*** 




LOG 


OFF 


19 


Oct 


83 


10:49:03 


LV 




a; 


I 08 




» » » 




LOG 


OFF 


19 


Oct 


83 


10:49:30 


JG 




c: 


I 3P 


F 


» « « 


ON: 






19 


Oct 


83 


10:52:01 


LV 




a; 


I 2P 


K 


« HC « 


ON: 






19 


Oct 


83 


11:03:29 


LV 




a: 


» 02 




X « » 





LOG 


OFF 


19 


Oct 


83 


11:03:35 


LV 




a: 


1 2P 


K 


« « * 


ON:UPSYS 




19 


Oct 


83 


11:05:33 


SKAl 




h; 


I 12 


E 


« « * 


ON: 






19 


Oct 


83 


11:51:01 


SKAl 




f; 


1 12 


E 


« « « 


ON: 






19 


Oct 


83 


11:58:59 


SKAl 




f: 


1 12 




« « * 




LOG 


OFF 


19 


Oct 


83 


12:00:20 


SKAl 




f: 


1 12 


E 


« » « 


ON: 






19 


Oct 


83 


12:01:05 


JSG 




g: 


> lOP 


B 


» X « 


ON: GEN 


PRINTS ON 9E 


19 


Oct 


83 


12:36:22 


HB 




h: 


) 12 


E 


« « » 


ON: 






19 


Oct 


83 


12:58:01 


HB 




H] 


i 12 




X * » 




LOG 


npy 


19 


Oct 


83 


12:58:26 


SKA 




h: 


) 14 


E 


X « « 


ON: 






19 


Oct 


83 


13:05:43 


LV 




a: 


I 2P 


K 


XXX 


ON: 






19 


Oct 


83 


13:14:21 


LV 




i; 


1 2P 


K 


XXX 


ON: 






19 


Oct 


83 


13:16:11 


SKAl 




f; 


1 12 




XXX 




LOG 


OFF 


19 


Oct 


83 


13:18:20 


SKAl 




f; 


I 12 


E 


XXX 


ON: 






19 


Oct 


83 


13:21:16 


LV 




:a; 


I 2P 


K 


XXX 


ON: 






19 


Oct 


83 


14:13:41 


SKAl 




:f: 


1 12 




XXX 




LOG 


OFF 


19 


Oct 


83 


14:23:10 


ML 




:h; 


1 2P 


M 


XXX 


ON: 






19 


Oct 


83 


14:42:18 


SKAl 




[F' 


1 12 


E 


XXX 


ON: 






19 


Oct 


83 


14:46:09 


JG 




[C 


) 10 




XXX 




LOG 


OFF 


19 


Oct 


83 


16:06:24 


RJ 




[C 


) 8P 


L 


XXX 


ON: 






19 


Oct 


83 


16:50:12 


JG 




[G 


) 3P 


F 


XXX 


ON: 






19 


Oct 


83 


17:04:27 


SKAl 




[F 


) 12 




XXX 




LOG 


OFF 


19 


Oct 


83 


17:09:53 


RJ 




[C 


) 02 




XXX 




LOG 


OFF 
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MAIL Command 



Syntax 



The HAIL command enables you to send mail to 
and receive mail from other users on the 
system. 




Explanation 



The userid parameter is optional. If it is 
absent, the program will put you into command 
mode, with a prompt of 'Mail>>>'. In this 
mode, you have eight valid commands: 



D Gives you a directory of all of your 
pending mail. The directory includes 
the letter number, a '*' if it is 
unread, the userid of the sender, the 
date and time when it was sent, and the 
subject of the letter. 

L This will give you a list, sorted 
alphabetically, of all the users on the 
system who have mailboxes. 

R This will read your next new letter. 
The letter will appear on the screen 
with a header telling you who sent it, 
and when it was sent. The letter will 
then be marked as having been read. 

S This permits you to send a letter 
to another user. You will first be 
prompted for the userid of the person 
to whom you are sending the letter. 
You will then be prompted for the 
subject of the letter and for the 
letter itself. The letter may be 
aborted with a control-Q, and ended 
with a control-E. 



Kn This command will kill 
'n' , as specified by 
letter numbers. 



letter number 
the directory 



n This coimnand displays letter number 'n' 
on the screen in the same format as the 
'R' command. It enables you to reread 
old mail which has not been killed. 

H This displays a brief help menu for the 
command options. '?* will also produce 
this menu. 
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X This takes you out of MAIL, and returns 
you to the operating system. 

A This is a privileged command. It puts 
you into an administrative suh-command 
mode, with a prompt of 'Admin>>>', 
which has the following options: 

C This will prompt you for a userid, 
and create a mailbox for the 
specified user. 

D This will prompt you for a userid, 
and delete that user's mailbox If 
it exists. You ma*^ not delete a 
mailbox unless it is empty. 



This returns 
conmiand mode. 



you to the 



main 



H This displays a brief help menu for 
the administrative options. '?' 
will also produce this menu. 



X This takes you out mail 
returns you to the 
system. 



MAIL, and 
operating 



If a userid is present in the initial coimnand 
line, the program will go directly into send 
mode, asking you for the subject, and then 
the remainder of the letter. Upon completion 
of the letter, you will be returned to the 
TurboDOS coimnand level. 

If the user receiving mail is logged onto the 
system when the mail is sent, he will receive 
a message on his screen saying '*** You have 
mail from XXXXXXXX' , where XXXXXXXX is the 
userid of the person who sent the mail. 



Error Messages 



Corrupt mail directory file 
Letter number out of range 
That mail box does not exist 
That mail box already exists 
No letter number specified 
System file I/O error 
Unauthorized user 
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Parameters 



SDRIVE =01 



CLSCR = I.IA 



ECHAE = '^E' 



QCHAH = "^Q' 



System search dri'v^e 
(1=A, 2=B, etc.) 

This may be a string of 
up to 10 bytes for the 
terminal clear-screen 
sequence. The first byte 
specifies the length of 
the string. 

The character used for 
indicating the end of 
a letter on input for 
the send command. 

The character used to 
abort a letter on input 
for the send command. 



2-22 



User's Guide to Turbo-Plus 



HASTEB Command 



The Turbo-Plus MASTER command replaces the 
TurboDOS coimnand of the same name. In a 
networking configuration of TurboDOS which 
has a remote master console, the HASTEH 
command allows you to attach your console to 
the master Dpocessor. 



Syntax 




Explanation 



This command attaches your console to the 
rnog^op "npocessor. To detach from the master 
processor (and resume normal local console 
operation), enter an Attention-Abort sequence 
<CTRL-S><CTRL-C> . 



While attached to the master, you can make 
attention requests of the master processor by 
using CTRL-A (instead of the usual CTRL-S). 

In order to use the MASTER coimnand, it is 
necessary that the master operating system be 
generated with the remote console driver 
module (CONREM) . 

The Turbo-Plus master command differs from 
that which it replaces because it does not 
allow more than one user into the master at 
once, and it keeps track of who is in the 
master for the WHO command. (Of. WHO Command) 
Furthermore, if you attach to the MASTER 
while it is in the process of executing a 



J WW , 



JfWU. n ^ ± J. X9\/€x«@ Or V¥«»AAXXJMg ^xVXA^g ^w«A 



the name of the program which is running, so 
that you do not accidentally give it any 
unwanted console input. If no job is 
running, you will receive the normal TurboDOS 
prompt . 
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Ex amp 1 e 



gBl MASTER 

Console attached to master processor 

OAIBACKUP A: B: 



OA} 

<CTRL-S CTRL-C> 



Console detached from master processor 
! 3B} 



Error Messages 



Non-privileged user 

Remote console driver not present 

Master processor is busy 
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PROFILE Command The PROFILE command enables privileged users 

to add and delete userid's from the system 
user file in a menu— driven environment. 



Syntax 



Explanation Upon issuing the PROFILE command, the user 

will be presented with the following menu: 

User Identification Maintenance 



A Add a System User 

D Delete a System User 

L List All System Users 

E Exit Program 

Enter Choice >>> 

If the user specifies choice 1, he will be 
asked a series of questions about the new 
user, as follows: 



Enter Userid (Max 8 characters): ACCOUNT 

Enter Password (Optional: If present, max 8 characters): MYPASS 

Enter User Number (0-31) : 10 

Is the user to be privileged (Y/N)? N 

Drive to log on to (Optional: If present, A-P)? D 

Command to execut upon logon (Optional: If present, 

up to 40 ASCII character)? WHO 

Drives to restrict user to (Optional: If present, combinations 

of A-P)? ADHI 



To exit from this mode, the user must press 
the return key when prompted for a userid. 

If the user specifies choice 'D' , he will be 
prompted for the userid to delete. Pressing 
the return key will return him to the main 
menu. Giving a userid will result in either 
that userid being deleted, or, if it is not 
found, an error message being returned. 

If the user specifies choice 'L' , the 
USERID. SYS file will be displayed in five 
columns: userid, password, user niimber, 
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default drive, and access, with the aommand 
line, if any, appearing on a sep&rateL line 
immediately below. The program will pause 
after each screenful, and wait for the return 
key to be depressed before continuing. $ 



EFTor Has sag as 



If the user specifies choice 'E' , 
returned to the operating system. 



he will be 



Duplicate User id 

Non-priveleged user 

Userid not present in file 

There is no USERID. SYS file on the 

system disk 



Parametera 



CLSCR = 1,1A 



This may be a string of up 
to 10 bytes for the 
terminal clear- screen 
sequence. The first byte 
spcifies the length of the 
string. 
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BESET Command 



The BESET command is a privileged coimnand 
which enables you to reset any station on the 
system. 



Syntax 



Explanation 



Example 



Error messages 



BESET station 
BESET 



The "station" parameter is optional, and, if 
present, identifies the station to be reset. 
If absent, the program prompts the user for 
the station to be reset: "Station to reset 



I A _ 






uoox~ tuuow i; V o y \J ■Li'jL wx wax 



station letter or he will be asked again. 

Once the station to be reset has been 
determined, the user is prompted for 
verification, with the question: "Okay to 
reset station x (Y/N)?" If the user says 
that the station is to be reset, then that 
station is downloaded by the master. If not, 
he is simply returned to the operating 
system, and nothing happens. 



8L} RESET C 

Okay to reset station C (Y/N)? Y 
8L} 



Non-Privileged user 
Illegal Station Letter 
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STATUS Command 



Synta-is 



The STATUS command enables you to 
continuously monitor the system status . It 
will maintain on your screen a list of who is 
currently logged onto the system, what each 
of the users is currently doing, and obtain 
status reports on the system buffers and 
printers. 




Explanation 



STATUS gives a report showing all system 
activity. It then continually updates the 
report at a specified time interval. 



The header line shows the current date and 
time, and the last time the system was reset. 



Each 


other 


user 


on the 


that 


user i 


user, 


the 


the 


.COM 



executing, 
ran that pro 
of the line 
command. I 
shows all of 
the static 
attached. 



line in 

system 
s working on, 
time and date 

file which 
and the user 
gram. A star 
displaying the 



the report describes one 

It shows what station 

the user i d o f that 

when he logged on, 

he is currently 

area from which he 

appears to the left 

user who typed the 



f the Master is logged on, it 

the same information, as well as 

n to which it is currently 



Below this table, a line appears displaying 
the number of I/O buffers currently active in 
the system. 

Finally, there is a list of each printer 
defined for the station running the program, 
both local and remote, and from what queue, 
if any, that printer is despooling. 

After five seconds, the screen will be 
cleared, and an updated report will appear. 
The program will continue running until 
aborted with a <ctrl-X> character. 
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30P} STATUS 




Turbo+ VI. 41 • 


- 01-Apr- 


Station 


Userid 


MST 




A 


LV 


B 


BB-1248 


G 


JIM 


P 


NB 


* I 


EON 



- Ol-Apr-85 18:21 Last System Reset : 10: 23:42 26-Map-85 



Log. 


Time On 


Date On 


Process 








— idle— 


02-J 


08:51:13 


13-Jul-84 


ED 


08-K 


14:38:19 


13-JU1-84 


REACT 


30-F 


13:57:51 


13- Jul -84 


GEN 


02-M 


09:30:12 


13-JU1-84 


WSTN 


05-L 


10:05:15 


13-Jul-84 


STATUS 



OA} 



Number of Buffers: 14 



Printers: 








Printer 


A: 


Queue 


A 


Printer 


B: 


Queue 


B 


Printer 


D: 


Queue 


C 



Parameters 



TDELAY = 5 



The number of seconds 
to wait between screen 
refreshes . 

This may be a string of 
up to 10 bytes for the 
terminal clear-screen 
sequence. The first byte 
specifies the length of 
the string. 
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TUX Comm&nd 



Syntax 



The TWX command enables you to communicate 
instantly with other users who are logged 
onto the system. 



TWX destid 

TWX destid message 



Sjcp I ^^ nation 



Th@ message parameter is optional. If it is 
absent, the program will prompt you with 
asterisks for each line of a multi-line 
message to send to the specified user. 
Pressing the return key at the prompt (i.e. 
giving it a null line) will terminate the 
program. 

The destid parameter must specify the user 
who is to receive the message. This may be 
either in the form of a userid, a station 
letter, preceded by an exclamation mark (e.g. 
lA for station A) , ar ALL, for everybody who 
is logged onto the system. 

If a userid and message are both present, TWX 
will send a single line message to the 
specified userid and automatically terminate. 



Once a message is sent, 
appear on the consol 
receiver(s). If a use 
message will be sent t 
the specified userid i 
message will never b 
sending it, whether 
specified userid or it 
user attempts to send a 
which is not logged ont 
receive an error messag 



it will immediately 
e(8) of the intended 
rid is specified, the 
o all stations which 
s logged on to. The 
e sent to the user 
or not he is the 
is a TWX ALL. If the 
message to a station 
o the system, he will 
e . 



When a user 
preceded by 
FROM srcid:" 
user sending 
not have a u 
from a stat 
specified) 
FROM STAT, x 
or "*•* fROM 



receives a message, it will be 
a header line of the form "*«« 

where srcid is the userid of the 

the message. If that user does 
serid, (i.e. he is running TWX 
ion or MASTER which has an AUTUSR 
the header line will read »'*«* 
:" where x is the correct letter, 

MASTER:" in that case. 



If a user wishes to disable his station from 
receiving TWX messages while he is working, 
he may issue the 'TWX .OFF' command. Anybody 
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who tries to send liim a message will recelTe 
a message that 'Station X has disabled 
messages'. To resume receiving messages, 
issue the 'TWX .ON' command. 



Examp 1 e s 



13F}T1^ RJ 
« RON: MEETING At 1^ 
* CAN YOU MAKE IT? 
13P}***From EJ 



: YES, SEE YOU THEN 



GAjTWX ALL SYSTEM COMING DOWN IN 8 MINS 



Error Messages 



Station has disabled messages 

No userid present in command line 

Userid too long 

Station unable to receive message 

User is not currently logged on system 
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USEB CGmmand 



Syntax 



The USEE command lets you change the current 
user number. 




Explanation 



Examples 



The '*nn" argument specifies the desired user 
number (in the range to 31). If "nn" is 
omitted, the command displays the current 
user number (which also appears in the com- 
mand prompt) . 

The USEB command is restricted to privileged 
log-ons only. 



OAIUSER 2 

Current user number: 2 

2A1USER 

Current user number: 

OA) 



Error Messages 



Invalid user number requested 
Non-privileged user 
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WHO Commaiid 



The WHO command enables you to find out who 
is currently logged onto the system, what 
each of the users is currently doing, and 
obtain status reports on the system buffers 
and printers. 



Syntax 




Explanation 



WHO gives a 
activity. The 
date and time. 



report showing all system 
header line shows the current 
and the last time the system 



Each other 
user on the 
that user i 
user, the 
the .COM 
executing, 
ran that pro 
of the line 
command. I 
shows all of 
the static 
attached. 



line in the report describes one 
system. It shows what station 
the userid of that 
when 
he 
area 



s working on, 
time and date 

file which 
and the user 
gram. A star 
displaying the 



he logged on, 
is currently 
from which he 
appears to the left 
user who typed the 



f the Master is logged on, it 

the same information, as well as 

n to which it is currently 



Below this table, a line appears displaying 
the number of I/O buffers currently active in 
the system. 

Finally, there is a list of each printer 
defined for the station running the program, 
both local and remote, and from what queue, 
if any, that printer is despooling. 
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Ex amp 1 e 



132M1WHO 

Tarbo+ VI. 41 - g6"Mar-85 13:12 Last System Reset : 09: 40: 03 21-Mar-85 
Station Userld Loc. Time On Date On Process 



MST 










FORMAT 


A 


HON 


08-1. 


09:01:36 


26-Mar-85 


TIP 


B 


BB-IDLE 


30-H 


12:24:36 


26-Mar-85 


-batch- 


C 


JIM 


04-F 


08:30:13 


26-Mar-85 


MUASM 


D 


LV 


08-J 


08:50:15 


26-Mar-85 


MONITOR 


B 


HB 


05-0 


11:22:21 


26-Mar-85 


TWX 


. p 


NB 


12-M 


08:45:15 


26-Mar-85 


WHO 


G 


SKAl 


07-1 


12:51:12 


26-Mar-85 


TFM 


H 


ROBERT 


06-F 


12:00:01 


26-Mar-85 


MBAS 



Number of Buffers: 14 



Printers : 

P r in t e r A : f 11 i n 8 

Printer B: Queue H 

Printer D: Queue A 
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FUNCTIONS 

Turbo-Plus makes extensive use of the TurboDOS user defined 
function call, in which the C register is set to 29H, Sub- 
functions are defined by the USRSUP protocol. 

You may use your own user functions, as long as they conform with 
the USHSUP calling sequence protocol recognized by Software 2000 
under VI. 41 as the standard TurboDOS user function method. For a 
deatiled explanation on USESUP, refre to appendix C of the Tupbo- 
Plus VI. 41 8-bit installation guide, which contains the original 
USHSUP proposal as sumbitted to Software 2000. 

Turbo-Plus, consists of two modules: TPLUSM which is included in 
the master , GTilN and TPLUSS included in the slave .GSN. Under 
the USESUP scheme, both have the name 'T-PLUS ', since it is 
invalid to have them genned in a processor together. Their 
subfunctions, always defined (by USESUP definition) in the L 
register, are defined as follows: 

TPLUSM subfunctions 

The following function calls all refer to the tables described 
above. The master contains five such tables: a 128 byte table of 
all users currently logged on, a 128 byte table of data about 
those users, a nine byte table keeping the master's ID, an eight 
byte table holding data about the master, and an eight byte table 
holding the system uptime. All of the tables are outlined in the 
section following the description of the function calls. 

For the TPLUSM functions, under normal network configurations, 
the routing may be done explicitly, with OFEH in the B register, 
and the master's address (generally OOOOH) in the DE pair; or by 
default routing methods with the B register set to OFFH when 
called from a slave, and OOH when called from the master. 
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Function OIH: Clear Master Userid Table 
Called Witlx: L =' OIH 

Function 02H: Be turn Master XTserid 

Called With: L ^ 02H 

Notes: Upon return from the function call, the first eight 
bytes of the record buffer will contain userid of the person 
fiurrently logged onto the master processor. 

Function 05H: Chang e Master Userid 

Galled With: L = 03H 

First eight bytes of record buffer contain 
new userid of master processor. 

Function OEH: Clear System Userid Table 
Called With: L » OEH 

Function OFH: Be turn System Userid Table 

Called With: L = OFH 

Notes: Upon return from the function call, the record buffer 
will contain the 128 byte table containing the userids of 
every user currently logged onto the system. 

Function lOH: Modify System Userid Table 

Called With: L » lOH 

H = Slave number (0-16) to which user is 

attached. 
First eight bytes of record buffer contain 
userid of slave being modified. 

Function IIH: Clear System Data Table 
Called With: L ^ IIH 
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Function 12H: Be turn System Data Table 

Called With: L = li3H 

Notes: Upon return from the function call, the record buffer 
will contain the 128 byte table containing the data records 
of every user currently logged onto the system. 



Function IgH: Modify System Data Table 

Called With: L = 13H 

D - Slave number (0-15) to which user is 
attached. 

1? It* fit. o i *J>i +. Viv^t. oei r\f t»o<^at»H V>n f -f o t» /»/>t^+. o<t^ 

data record of slave being modified. 



Function 15H: Be turn Master Data Becord 

Called With: L = 15H 

Notes: Upon return from the function call, the first eight 
bytes of the record buffer will contain the data record 
describing the current state of the master processor. 

Function 16H: Change Master Data Becord 

Called With: L = 16H 

First eight bytes of record buffer contain 
new data record of master processor. 



Function 17H: Set System Beset Time 

Called With: L = 17H 

First eight bytes of record buffer contain 
time and date of last system reset. 



Function 18H: Be turn Last System Beset Time 

Called With: L = 18H 

Notes: Upon return from the function call, the first eight 
bytes of the record buffer will contain the record 
containing the time and date of the last system reset. 
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Funct ion 19H: Clear System Process Table 
Galled With: L ^ 19H 

Function lAH: Return System Process Table 

Galled With: L = lAH 

Notes: Upon return from the function call, the record buffer 
will contain the 128 byte table containing the current 
processes being run by every user logged onto the system. 

Function IBH: Modify System Process Table 

Galled With: L = IBH 

H = Slave number (0-15) to which user is 

attached. 
First eight bytes of record buffer contain 
the process currently loaded in the slave 
indicated by the D register. 
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System Userid 
Bytes 
0. .7 



8. .15 
16. .23 
24. .31 
32. .39 
40. .47 
48. .55 
56. .63 
64. .71 
72. .79 
80. .87 
88. .95 
96. .103 
104. .111 
112. .119 
120. .127 



Master Inf ormat i on Tabl es 

Table Organization: 

Field Description 

Userid A The userid of the user currently logged 
onto slave A. If nobody is currently 
logged onto the slave, the first byte 
will be 0. If slave A is currently 
attached to the master processor, the 
first byte will have the high bit set. 



Userid B 
Userid C 
Userid D 
Userid E 
Userid P 
Userid G 
Userid H 
Userid I 
Userid J 
Userid K 
Userid L 

uS cT X u. n 

Userid N 
Userid 
Userid P 
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Master XTserld Table Origanlzation: 

Bytes Field Description 

0..7 Userid The userid of the user currently logged 

onto the master processor. If nobody is 
currently logged onto the master,? the 
first byte will be 0, 

8 ID Contains a byte corresponding to the 

slave number assigned to each slave. 
For the master, this entry is fixed at 
lOH. 
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System Data Record Table: 

Bytes Field Description 



0. .7 



8. .15 
16. .23 
24. .31 
32. .39 
40. .47 
48. .55 
56. .63 
64. .71 
72. .79 
80. .87 
88. .95 
96. .103 



A Data 



B Data 
C Data 
D Data 
E Data 
F Data 
6 Data 
H Data 
I Data 
J Data 
K Data 
L Data 
M Data 



t r\A tit TiTt T\~ *. ^ 

J.WX . .J.XX XM uaba, 

112. .119 Data 

120. .127 P Data 



The data record, as described below, for 
the user currently logged onto slave A. 
If nobody is currently logged onto the 
slave, this record is to be ignored, and 
may still contain the data pertaining to 
the last user logged onto the slave. 



8 Byte Record: 

!HIMIS!R!R!R;DID! 
H,M,S = Logon Time 
R = Reserved Bytes 
DD - Julian Logon Date 
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Master Data Becord Table Organization: 

Bytes Field Description 

0..7 Data The data record, as described above for 

the master processor. If nobody is 
currently logged onto the master, this 
record is to be ignored, and may still 
contain the data pertaining to the last 
user logged onto the master. 

.iZllfJ^ XTPtime Table Organliiation: 

By teg Field Description 

0,.7 Uptime A data record, with a format the same as 

that described for the slaves, 
containing the time and date that the 
system was last reset. 



3-8 



User's Guide to Turbo-Pliis 



System Process Table 
Bytes 

0. .7 



Field 



8. .15 
16. .23 
24. .51 
32. .39 
40. .47 
48. .55 
56. .63 
64 . . 71 
72. .79 
80. .87 
88. .95 
96. .103 
104. .111 
112. .119 
120. .127 



A Proc 



Description 

The process currently loaded in memory 
in the user currently logged onto slave 
A. If nobody is currently logged onto 
the slave, this record is to "be ignored, 
and may still contain the data 
pertaining to the last user logged onto 
the slave. 



B Process 
G Process 
D Process 
E Process 
F Process 
G Process 
H Process 
I process 
J Process 
K Process 
L Process 
M Process 
N Process 
Process 
P Process 
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TPLUSS sub functions 



The following function calls refer to the tables in 
processors. Once again, the tables are outlined in 
following the description of the function calls. 



the slave 
the sejction 



For the TPLUSS functions, under normal network configurations, 
the routing must be done explicitly, with OPEH in the B register, 
and the address of the slave being called in the DE pair. This 
is generally 0001 for slave A, 0002 for slave B, etc. „In multi- 
circuit systi»ms, you must refer to your slave table (TPSTBL), 
defined in appendix B of the installation guide. The tables set 
up for your system in the master .PAR file will show you the 
network address of each of your slaves, A through P, in that 
order. 

Fu BCtion OIH: Clear Local Userid Table 

Galled With: L ^ OIH 



Function 02H: Heturn Local Userid 



Galled With: 



L = 02H 



Notes: Upon return from the function call, the first eight 
bytes of the record buffer will contain userid of the person 
currently logged onto the slave board to which the function 
call was routed. 



Function 05H: Change Local Userid 



Called With: 



L = 03H 

first eight bytes of record buffer contain 
new userid of slave processor to which the 
function call was routed. 



Function 08H: Beset Local Slave 



Called With: 



L = 08H 



Notes: A successful return from this call indicates that the 
slave board to which the call was routed has been (or is 
being) downloaded by the master. 
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Function 09H: Send Message to Console of Local Slave 

Called With: L == 09H 

Eecord "buffer contains up to 80 bytes which 
will be sent, through comm channel zero, to 
the console of the slave to which the call is 
routed, preceded by a shift-in character, and 
followed by a shift-out. 

Notes: A successful return from this call indicates that the 
message sent in the record buffer was received by the slave, 
and displayed on the console of that slave. If that slave 
has a special TWX console manager genned in, (see 
Installation Guide to Turbo-Plus), the shift-in/shift-out 
b'^'tes ma'^ cause the message to be dis'^la'^'^ed in a s*"ecial 
manner on the screen. 



Function OAH: Enable Messages to Local Slave 

Called With: L = 21H 

Notes: A successful return from this call indicates that the 
slave to which the call was routed will one again be able to 
receive messages sent via function 20H, reversing the 
effects of function 22H. 

Function OBH: Disable Messages to Local Slave 

Called With: L = 22H 

Notes: A successful return from this call indicates that the 
slave to which the call was routed will ignore any 
subsequent calls of function 20H, \intil messages are enabled 
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Slave Information Tables 

Slave TTserid Table Organization: 

Bytes Field Description 

0..7 Userid The userid of the user currently logged 

onto the slave processor. If nobody is 
currently logged onto the slave, the 
first byte will be 0. 

8 ID Contains a byte corresponding to the 

slave number assigned to each slave. 
For slave A, this will be 0, for slave 
B, it will be 1, etc. 
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